FrameRoundRect

Draw a rounded-corner rectangle

#include <Quickdraw.h> Quickdraw

void FrameRoundRect( theRect, ovalWidth, ovalHeight );

Rect *theRect ; rectangle defining position and size

short ovalWidth ; width and . . .

short ovalHeight ; height defining curvature of corners

FrameRoundRect draws the outline of a rounded-corner rectangle that fits

just inside a specified rectangle. The outline is drawn in the current pen size,

pattern and transfer mode.

theRect is the address of an 8-byte Rect structure, defined in local

coordinates.

ovalWidth and . . .

ovalHeight specify the curvature of the corners. Small values make sharper

corners; large values specify more "rounding". See the figures,

below.

Notes: This call is similar to framing a rectangle, then drawing four identical

ovals to replace the rectangle's corners:

There are no particular constraints on ovalHeight or ovalWidth . Notice

that in the rightmost figure the ovals overlap.

Here's a gauge for various curvatures:

2,2 4,4 6,6 8,8 10,10 12,12 20,20 24,24

The standard push-button control uses a curvature of 10,10. The top of

the desktop "gray region" is a roundRect with a 16,16 curvature.

FrameRoundRect doesn't change the pen position.

As with all Quickdraw drawing, the output is clipped to the intersection of

the current GrafPort's bitMap boundary rectangle, the port rectangle,

clipping region, and visible region.

If a region is being recorded (see OpenRgn), FrameRoundRect

mathematically adds the area enclosed by the outline of the roundRect to it.

Referenced by (31):